home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / utils / groff.txt < prev    next >
Text File  |  1994-08-27  |  3KB  |  51 lines
  1. Hi all,
  2.  
  3. This is the `readme' file for my port of GNU groff 1.07 for the Atari ST.
  4. This file is included in the groff archives, but should also remain with the
  5. archives on all FTP sites to save people transferring megabytes for nothing.
  6.  
  7. Groff is a typesetting program that can produce dvi, ascii, PostScript and
  8. X11 output. If you only need nroff to format manpages for ascii, you'll
  9. be better off with Bill Rosenkranz's nroff. If you want to do typesetting
  10. and you don't have nroff experience, maybe you'd better learn LaTeX.
  11.  
  12. Groff has been ported for MiNT. It will not work with TOS. Also, you'll need
  13. quite a bit of memory for it to work. If you have 1 Mb or less, forget it.
  14. If you have 2 Mb, it may just work, if you don't have too many other
  15. programs and accessories around. If you have more memory, fine: you should
  16. not have any problems.
  17.  
  18. Groff takes a *lot* of harddisk space (forget about using floppy disks).
  19. The binaries alone take 1.5 Mb, the man pages take 200 Kb, and the library
  20. files take 1.2 Mb. If you don't want to produce PostScript and X11 output,
  21. the library files will take 600 Kb.
  22.  
  23. The library files (and preferably, the man pages too) should remain on
  24. a minix partition of your harddisk. You may experience problems if
  25. you put the library file on a TOS (MS_DOS) partition.
  26.  
  27. Finally, some programs need `perl' to function. Don't worry, though, if you
  28. don't have perl; it is unlikely that you'll need these programs. The
  29. programs affected are `afmtodit', a program that analyses PostScript font
  30. decsription files, and `grog', a program that tries to guess what
  31. groff parameters you'll need an then calls groff for you. Grog will also
  32. work, although less ably, if you have a shell (/bin/sh).
  33.  
  34. This port of groff comes in two zoo archives:
  35.  - groffbin.zoo, which contains the programs
  36.  - groffvar.zoo, which contains the library files, the man pages, etc.
  37. The second archive contains two tar files. Please use a real tar program
  38. to untar these files, for instance GNU tar 1.11.1.
  39. An old tar may damage filenames not fitting the MS-DOS 8+3 rule, of which
  40. there are many. (Otherwise, I'd have zoo'd the stuff. But then, most zoo
  41. programs around also damage  filenames not fitting the 8+3 rule.)
  42.  
  43. Installation info is contained in the file `install', which is included
  44. in both archives. That file will tell you what environment variables to
  45. set, what to put where, etc. It is safe to un-zoo both archives on any
  46. drive that has enough free space left, be it a TOS or a minix partition.
  47.  
  48. Any questions, comments, bug-reports etc. should go to:
  49. Hildo Biersma // boender@dutiws.twi.tudelft.nl
  50.                  schuller@dutiag.twi.tudelft.nl
  51.